IRIX Base Documentation 2002 November/SGI IRIX Base Documentation 2002 November.iso/usr/share/catman/p_man/cat3/il_c/ilHwContext.z/ilHwContext

Text File | 2002-10-03 | 9.2 KB | 265 lines

iiiillllHHHHwwwwCCCCoooonnnntttteeeexxxxtttt((((3333))))     IIIImmmmaaaaggggeeeeVVVViiiissssiiiioooonnnn LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll     iiiillllHHHHwwwwCCCCoooonnnntttteeeexxxxtttt((((3333))))



NNNNAAAAMMMMEEEE
     iiiillllHHHHwwwwCCCCoooonnnntttteeeexxxxtttt - an OpenGL rendering context

IIIINNNNHHHHEEEERRRRIIIITTTTSSSS FFFFRRRROOOOMMMM
     iflListItem

HHHHEEEEAAAADDDDEEEERRRR FFFFIIIILLLLEEEE
     #include <il/ilCdefs.h>

CCCCLLLLAAAASSSSSSSS DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
     ilHwContext is used to manage creation and destruction of OpenGL
     contexts.  Some basic attributes of the context can be queried.
     ilHwContext is also responsible for recording the current state of the
     context and provides methods for some state alterations.

     The ilHwContext shadows much of the OpenGL state. For maximum
     performance, The enable/disable methods only make calls to OpenGL if the
     requested state is different than the current OpenGL state.

CCCCLLLLAAAASSSSSSSS MMMMEEEEMMMMBBBBEEEERRRR FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN SSSSUUUUMMMMMMMMAAAARRRRYYYY
     CCCCoooonnnntttteeeexxxxtttt mmmmaaaannnnaaaaggggeeeemmmmeeeennnntttt

     XXXX aaaattttttttrrrriiiibbbbuuuutttteeee qqqquuuueeeerrrriiiieeeessss

          Display* ilHwContextGetDisplay(ilHwContext *obj)
          GLXContext ilHwContextGetContext(ilHwContext *obj)
          VisualID ilHwContextGetVisualID(ilHwContext *obj)

     RRRReeeennnnddddeeeerrrriiiinnnngggg ccccaaaappppaaaabbbbiiiilllliiiittttiiiieeeessss qqqquuuueeeerrrriiiieeeessss

          int ilHwContextGetCapability(ilHwContext *obj)
          int ilHwContextIsDirect(ilHwContext *obj)
          int ilHwContextIsDoubleBuffer(ilHwContext *obj)
          int ilHwContextIsStereo(ilHwContext *obj)
          int ilHwContextNeedsFlush()

     CCCCoooommmmppppoooonnnneeeennnntttt ssssiiiizzzzeeee qqqquuuueeeerrrriiiieeeessss

          int ilHwContextGetAlphaSize(ilHwContext *obj)
          int ilHwContextGetRedSize(ilHwContext *obj)
          int ilHwContextGetGreenSize(ilHwContext *obj)
          int ilHwContextGetBlueSize(ilHwContext *obj)













                                                                        PPPPaaaaggggeeee 1111






iiiillllHHHHwwwwCCCCoooonnnntttteeeexxxxtttt((((3333))))     IIIImmmmaaaaggggeeeeVVVViiiissssiiiioooonnnn LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll     iiiillllHHHHwwwwCCCCoooonnnntttteeeexxxxtttt((((3333))))



     SSSSttttaaaatttteeee aaaalllltttteeeerrrraaaattttiiiioooonnnn

          void ilHwContextSetBuffer(ilHwContext *obj, int buffEnables,
                                    int read)
          void ilHwContextSwapBuffers(ilHwContext *obj, Drawable drawable)

     IIIILLLL ttttoooo GGGGLLLL ttttrrrraaaannnnssssllllaaaattttiiiioooonnnnssss

     MMMMeeeetttthhhhooooddddssss ttttoooo sssseeeetttt GGGGLLLL ssssttttaaaatttteeee

FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNNSSSS
     ggggeeeettttAAAAllllpppphhhhaaaaSSSSiiiizzzzeeee(((())))

          int ilHwContextGetAlphaSize(ilHwContext *obj)


          This method returns the actual alpha component size for this visual,
          as seen by OpenGL.

     ggggeeeettttBBBBlllluuuueeeeSSSSiiiizzzzeeee(((())))

          int ilHwContextGetBlueSize(ilHwContext *obj)


          This method returns the actual blue component size for this visual,
          as seen by OpenGL.

     ggggeeeettttCCCCaaaappppaaaabbbbiiiilllliiiittttyyyy(((())))

          int ilHwContextGetCapability(ilHwContext *obj)


          This method returns the rendering capabilities of this context as
          defined by ilHwCapability in <il/ilHwConnection.h>.  These are
          capabilities actually supported in hardware, not just emulated in
          software.

     ggggeeeettttCCCCoooonnnntttteeeexxxxtttt(((())))

          GLXContext ilHwContextGetContext(ilHwContext *obj)


          Returns the GLXContext for this ilHwContext.

     ggggeeeettttDDDDiiiissssppppllllaaaayyyy(((())))

          Display* ilHwContextGetDisplay(ilHwContext *obj)


          Returns the X Display* for this context.





                                                                        PPPPaaaaggggeeee 2222






iiiillllHHHHwwwwCCCCoooonnnntttteeeexxxxtttt((((3333))))     IIIImmmmaaaaggggeeeeVVVViiiissssiiiioooonnnn LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll     iiiillllHHHHwwwwCCCCoooonnnntttteeeexxxxtttt((((3333))))



     int ilHwContextGetGreenSize(ilHwContext *obj)



     This method returns the actual green component size for this visual, as
     seen by OpenGL.

     ggggeeeettttRRRReeeeddddSSSSiiiizzzzeeee(((())))

          int ilHwContextGetRedSize(ilHwContext *obj)


          This method returns the actual red component size for this visual,
          as seen by OpenGL.

     ggggeeeettttVVVViiiissssuuuuaaaallllIIIIDDDD(((())))

          VisualID ilHwContextGetVisualID(ilHwContext *obj)


          This method returns the X VisualID of this context.

     iiiissssDDDDiiiirrrreeeecccctttt(((())))

          int ilHwContextIsDirect(ilHwContext *obj)


          This method returns TRUE if this context is a direct context.

     iiiissssDDDDoooouuuubbbblllleeeeBBBBuuuuffffffffeeeerrrr(((())))

          int ilHwContextIsDoubleBuffer(ilHwContext *obj)


          This method returns true if this context supports double buffering.

     iiiissssSSSStttteeeerrrreeeeoooo(((())))

          int ilHwContextIsStereo(ilHwContext *obj)


          This method returns true if this context supports stereo rendering.
          nnnneeeeeeeeddddssssFFFFlllluuuusssshhhh(((())))

          int ilHwContextNeedsFlush(ilHwContext *obj)


          This methods returns true if this context requires a flush when
          switching to a _N_U_L_L context from this one.






                                                                        PPPPaaaaggggeeee 3333






iiiillllHHHHwwwwCCCCoooonnnntttteeeexxxxtttt((((3333))))     IIIImmmmaaaaggggeeeeVVVViiiissssiiiioooonnnn LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll     iiiillllHHHHwwwwCCCCoooonnnntttteeeexxxxtttt((((3333))))



     void ilHwContextSetBuffer(ilHwContext *obj, int buffEnables,
                               int read)



     This method sets the drawing buffer enables as defined by _b_u_f_f_E_n_a_b_l_e_s.
     Possible values can be formed by ORing the values ilFrontBuffer,
     ilBackBuffer, ilLeftBuffer and ilRightBuffer that are defined in
     <il/ilHwDefs.h>. If _r_e_a_d is _T_R_U_E then the OpenGL read buffer is set
     instead of the draw buffer.  sssseeeettttPPPPoooossssttttCCCCoooonnnnvvvvBBBBiiiiaaaassss(((())))

     sssswwwwaaaappppBBBBuuuuffffffffeeeerrrrssss(((())))

          void ilHwContextSwapBuffers(ilHwContext *obj, Drawable drawable)


          This method performs a glXSwapBuffers on the context.

SSSSEEEEEEEE AAAALLLLSSSSOOOO
     ilHwConnection(3), ilHwVisual(3), iflListItem(3)



































                                                                        PPPPaaaaggggeeee 4444